home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 026-050 / scopedisk33 / xoper11 / xoper.doc < prev    next >
Text File  |  1995-03-18  |  8KB  |  259 lines
  1.                                  Xoper V1.1
  2.  
  3.                     Copyright (c) Werner Gunther 1988
  4.  
  5. Xoper is a freeware program to display and to control system activity. If
  6. you find this program useful, feel free to send a donation to the address
  7. below.
  8.  
  9. Starting Xoper from CLI:
  10.  
  11. Xoper [T] [S] [L] [D] [R] [E] [M] [P] [I]
  12.  
  13. These parameters are decribed below. For all those who like long
  14. Startup-Sequences, overcrowded memory and hot-keys enter
  15.  
  16. Xoper -b
  17.  
  18. This will install Xoper in background waiting for LeftAmiga-RightAmiga-X
  19. to pop up. In both cases you don't have to RUN or RUNBACK Xoper, it will
  20. always create its own process.
  21.  
  22. Xoper Commands:
  23. ---------------
  24.  
  25.  Commands can be entered after the prompt '->', these are divided into two
  26. groups:
  27.  
  28. Display commands: These are always single character entries and may be
  29. specified in any order, upper or lower case, with or w/o enbedded blanks,
  30. after the prompt or from CLI as parameters:
  31.  
  32. T = Tasks (Default if Xoper is called without parameters)
  33. Task node (HEX), Display type, status, priority (decimal) ,processnumber
  34. for Dos-Processes (decimal), taskname.
  35.  
  36. S = Task Signals
  37. Task node (HEX), Allocated Signals (HEX), Signals the Task is waiting for
  38. (HEX), Signals received (HEX), Address of the next instruction to be
  39. executed (HEX).
  40.  
  41. L = Libraries
  42. Base address (HEX), open count (decimal), version (decimal), revision
  43. (decimal), flags (binary), libraryname.
  44.  
  45. D = Devices
  46. Base address (HEX), open count (decimal), version (decimal), revision
  47. (decimal), flags (binary), devicename.
  48.  
  49. R = Resident
  50. Base address (HEX), priority (decimal), flags (binary), version
  51. (decimal), type, name.
  52.  
  53. E = Resources (sorry)
  54. Base address (HEX), open count (decimal), version (decimal), revision
  55. (decimal), flags (binary), resource name.
  56.  
  57. M = Memory
  58. Lower and upper bounds (HEX), bytes free (HEX), attributes, priority
  59. (decimal), hunk name.
  60.  
  61. P = Ports
  62. Node address (HEX), portname, flags, signal bits (binary),queue length
  63. [number of messages] (decimal), taskname.
  64.  
  65. I = Interrupts
  66. Node address (HEX), pointer to interrupt data (HEX), pointer to interrupt
  67. code (HEX), priority (decimal),type [interupt queue the interrupt belongs
  68. to], interrupt name.
  69.  
  70. H = Help ( or ?)
  71. Show a list of commands.
  72.  
  73. Q = Quit
  74. Same as QUIT (see below).
  75.  
  76. Example: Entering TPM would display Tasks, Ports and Memory. The display
  77. would be updated after a few seconds (5 by default, may be changed
  78. anytime, see below.)
  79.  
  80. Other commands that do not display lists:
  81. These commands may be entered upper or lower case. Parameters enclosed
  82. in '<>' must be, enclosed in '[]' may be specified. Names are usualy
  83. entered as ascii-strings, it can however happen that two or more nodes of
  84. the same name exist. On tasks you may specify the DOS-Processnumber to
  85. sort them out. If everything fails, you can enter the Node-Address with a
  86. leading '$'. This Address will be checked first before the command is being
  87. executed. If the check fails, you'll get an error message or a warning or
  88. a prompt, depending on what went wrong. Names are always the last parameter
  89. to enter. This may seem strange, but it is the simplest way to get rid of
  90. enbedded blanks.
  91.  
  92. Time <seconds>
  93. Set time between updates. Minimum is 1 second, maximum is 255, default is 5
  94. seconds.
  95. Example: Time 1
  96.  
  97. Taskpri <priority> [processnumber] <taskname>
  98. Change the priority of a task. Values may range from -127 to 127, better
  99. use values between -5 and 5.
  100. Example: Taskpri 5 Xoper V1.0
  101.  
  102. Mypri <priority>
  103. Shortcut for "Taskpri Xoper <priority>"
  104. Example: Mypri 6
  105.  
  106. Pri <priority> <nodename>
  107. Change the priority of any other node. This commad does not work for Tasks.
  108. If the specified node has been found, the entire list the node belongs to
  109. will be resorted.
  110. Example: Pri 1 Chip Memory        (try to allocate memory in CHIP first)
  111.  
  112. Break [processnumber] <taskname>
  113. Set break signals. Useful for tasks running in background or from Workbench.
  114. Example: Break 3 New CLI
  115.  
  116. Signal <mask> [processnumber] <taskname>
  117. Set any other signal. Mask is a hexadecimal value with or w/o leading '$'.
  118. See task's SIGWAIT field for sensible values. Tasks normaly do not wait
  119. for signals only, but for messages, that's why this command may not have
  120. the desired effect, but it is quite useful for tasks hanging around and
  121. waiting for events that may never happen.
  122. Warning: Using Signal without any knowledge about what you are going to
  123. signal may cause a system-crash!
  124. Example: Signal 10000000 PopCLI III
  125.  
  126. Hunks [processnumber] <processname>
  127. Show location, BCPL-Pointers and length of memory blocks the process uses.
  128. Example: Hunks RAM
  129.  
  130. Files
  131. List lock, access, size and name of open files.
  132.  
  133. Locks
  134. List any lock.
  135. BUG: Trying to lock the Volume "RAM Disk" crashes the machine sometimes. If
  136. a Volume "RAM Disk" is found it will be replaced by the devicename "RAM:"
  137. (this has been fixed on WB 1.3). Make sure you don't have a disk labeled
  138. "RAM Disk" or you'll never see its locks:-)
  139.  
  140. Currentdir
  141. List current directory settings of all processes.
  142.  
  143. Devices
  144. List name,heads,sectors,tracks,startup-buffers and handler-process of every
  145. DOS-device.
  146.  
  147. Lockdrive <DF0 | DF1 | DF2 | DF3>
  148. Prevent DOS, Workbench and Disk-Validator from cluttering on the disk. This
  149. command isn't very useful, I just needed it myself.
  150.  
  151. Freedrive <DF0 | DF1 | DF2 | DF3>
  152. Re-enable a drive.
  153.  
  154. Windows
  155. List address and title of all windows.
  156.  
  157. Screens
  158. List address and title of screens.
  159.  
  160. Fonts
  161. List address,height,width,type,fist character and last character of all
  162. loaded fonts.
  163.  
  164. Windowfonts
  165. List Windows and associated fonts.
  166.  
  167. Freeze [processnumber] <taskname>
  168. Halt a Task. The task should be READY or WAITING. Frozen tasks are queued in
  169. a new list called FREEZED. When you leave Xoper, halted Task will be
  170. released.
  171. Example: Freeze Killer Graphics Task
  172.  
  173. Warm [processnum] <taskname>
  174. Restart a halted Task. Task must be FREEZED.
  175. Example: Warm Killer Graphics Task
  176.  
  177. Info <librarynode | devicenode>
  178. Show additional information stored in the lib_IdString field.
  179. Example: Info arp.library
  180.  
  181. Openlib <libraryname>
  182. Open a library. This is useful if you don't want a specified library being
  183. 'flushed' out.
  184. Example: Openlibrary arp.library
  185.  
  186. Clear [longword]
  187. Fill unused memory chunks with pattern, default is 0. Handy for debuggers.
  188. Example: Clear $66726565
  189.  
  190. Flush
  191. Clean up memory, flush unused libraries, devices and fonts.
  192.  
  193. Lastalert
  194. Show last Guru Meditation code or rubbish.
  195.  
  196. Taskports
  197. Disable / enable a listing of taskports if ports are displayed.
  198.  
  199. More
  200. Stop displaying "<MORE>" and "<RETURN>" if output exceeds window.
  201.  
  202. Quit or just Q
  203. Exit Xoper. If Xoper was started with '-b' or if 'Hold' was specified it
  204. will stay in background waiting for LeftAmiga-RightAmiga-X.
  205.  
  206. Hold
  207. Exit Xoper but install a key-handler and stay in background. Window
  208. settings and display commands are saved.
  209.  
  210. Exit
  211. Clean up and quit.
  212.  
  213. !!!! WARNING: The next few commands are dangerous and 'dirty' !!!!!
  214. !!!!!!!!!!!! don't use them if not strictly necessary !!!!!!!!!!!!!
  215.  
  216. Cancel [processnumber] <taskname>
  217. Cancel a task or a process. If the task has been called from CLI, the Task
  218. itself and the CLI will be killed. Hunks and the teminal-window will be
  219. freed. Simple tasks are just RemTask()'ed. If the process has been started
  220. from Workbench or fired up by another Process using CreateProc(), a promt
  221. will be displayed, asking you if you want to Unload() this process. On
  222. Workbench applications or processes using segment-splitting the answer
  223. shoud be YES, otherwise NO. This command is very useful if the task is in
  224. "Software Error-Task held" state.
  225.  
  226. Closewindow <title>
  227. Closes a Window. Please, use it only if the corresponding Task has been
  228. 'Cancel'ed. Use the Window-Structure address if the window has no name.
  229.  
  230. Closescreen <title>
  231. same as above, but for screens.
  232.  
  233. Unlock <lock (BPTR)>
  234. Unlock a file.
  235.  
  236. Closelib <libraryname>
  237. This is exactly the same as CloseLibrary().
  238.  
  239. CD [processnumber] <processname>
  240. Change the current directory of a process. You are prompted if the old
  241. directory lock should be unlocked.
  242.  
  243.  
  244. ----------------------------------------------------------------------------
  245.  
  246. Please send flames, bug reports and especially a list of features you would
  247. like to have included in the next version to
  248.  
  249.  Werner Gunther
  250.  Wingertspfad 12
  251.  D 6900 Heidelberg
  252.  (Germany)
  253.  
  254. or to my EMAIL address for a fast response:
  255.  
  256.  G35@DHDURZ1.BITNET
  257.  
  258.  
  259.